home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / fdsc210.zip / FILEDESC.DOC < prev    next >
Text File  |  1993-02-05  |  4KB  |  92 lines
  1.  
  2.                        File Description, Version 2.10
  3.                      Copyright (C) 1993 Daniel A. Gulkis
  4.                       The Data Center BBS (305-474-6560)
  5.                              All Rights Reserved
  6.  
  7.  
  8.         INTRODUCTION
  9.         ------------
  10.         FILEDESC is a utility for WildCat system operators.  It generates
  11.         a list of the files available on your BBS.  Other programs can do
  12.         this also, but I haven't found any with the same features.  The
  13.         special features of FILEDESC are:
  14.  
  15.           = Uses a compact format which lists the filename, size, date,
  16.             and description on a single line.  Only if the description
  17.             is over about 48 characters does it wrap to a second line.
  18.  
  19.           = Files are alphabetically sorted within each category.
  20.  
  21.           = After each category, a subtotal displays the number of files
  22.             and the total size of all files in the category.
  23.  
  24.           = At the bottom, a grand total shows the number of files and
  25.             total size of all files listed.  The total size is properly
  26.             displayed up to 4 gigabytes.
  27.  
  28.           = Any combination of categories can be selected for inclusion
  29.             in the file list.  By default, all categories will be listed.
  30.  
  31.           = No limit is placed on the number of files that can be listed.
  32.             Some other utilities can only handle what will fit in memory.
  33.  
  34.           = Reasonably quick.  Selecting and listing 11,000 files from
  35.             25,000 files takes 5 minutes on a 486/33 and 13 minutes on
  36.             a 286/12.  This is quite a bit faster than Mustang's WC!PRO.
  37.  
  38.  
  39.  
  40.         USE
  41.         ---
  42.         FILEDESC is designed to run with WildCat 3.5; it will not work
  43.         correctly with earlier versions.  It must be run from WildCat's
  44.         home directory.  This is the directory that contains MAKEWILD.DAT
  45.         and FILEAREA.DAT.  The syntax for using FILEDESC is:
  46.  
  47.           FILEDESC [ [/cn1 | /cn1-n2] ... ]
  48.  
  49.         The output is placed in FILEDESC.OUT.  The /c parameter may be
  50.         used to limit the output to certain file categories.  Examples
  51.         are:
  52.  
  53.           FILEDESC                 (All categories)
  54.           FILEDESC /c2             (Category 2)
  55.           FILEDESC /c9-15          (Categories 9 - 15)
  56.           FILEDESC /c1-4 /c9 /c16  (Categories 1,2,3,4,9,16)
  57.  
  58.         Six temporary files are used during processing:  FILEDESC.NT1,
  59.         FILEDESC.NT2, FILEDESC.TM1, FILEDESC.TM2, FILEDESC.TM3, and
  60.         FILEDESC.TM4.  These files will be deleted upon completion of
  61.         the program.  A considerable amount of disk space is used while
  62.         creating and sorting the list.  As a rule of thumb, you should
  63.         have at least 300k of disk space for each 1,000 files that are
  64.         selected and listed.
  65.  
  66.         During processing, you may press any key to abort and exit.  The
  67.         temporary files will not be cleaned up if you do this.
  68.  
  69.         REGISTRATION
  70.         ------------
  71.         FILEDESC is distributed as shareware.  If you find this program
  72.         helpful, please send a small contribution to Daniel A. Gulkis,
  73.         8989 W Sunrise Blvd, Plantation, FL 33322.
  74.  
  75.         If you have any comments on FILEDESC, I can be reached at the
  76.         address above, at The Data Center BBS (305-474-6560), or on
  77.         the Mustang Software Support BBS.
  78.  
  79.         WARRANTY
  80.         --------
  81.         FILEDESC is provided without any warranty, expressed or implied.
  82.         In no event shall the author be liable for damages arising out of
  83.         the use of this program.
  84.  
  85.         LICENSE
  86.         -------
  87.         You may distribute FILEDESC to others under the following two
  88.         conditions.  First, no fee, other than a nominal distribution
  89.         fee, may be charged.  Second, all related files must be
  90.         distributed without modification.
  91.  
  92.